
package org.dromara.system.api.feign;

/**
 * @author: zhou shuai
 * @date: 2024/10/5 17:10
 * @version: v1
 */

import org.dromara.common.core.domain.R;
import org.dromara.system.api.domain.vo.RemoteDeptVo;
import org.dromara.system.api.feign.fallback.SystemDeptFallBack;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.List;
import java.util.Map;

import static org.dromara.common.core.constant.ServerNameConstants.SYSTEM_SERVER_NAME;

@FeignClient(contextId = "system-dept-api", name = SYSTEM_SERVER_NAME, fallbackFactory = SystemDeptFallBack.class)
public interface SystemDeptClient {

    /**
     * 通过部门ID查询部门名称
     *
     * @param deptIds 部门ID串逗号分隔
     * @return 部门名称串逗号分隔
     */
    @GetMapping(value = "/api/system/dept/name/byDeptIds")
    R<String> selectDeptNameByIds(@RequestParam("deptIds") String deptIds);

    /**
     * 根据部门ID查询部门负责人
     *
     * @param deptId 部门ID，用于指定需要查询的部门
     * @return 返回该部门的负责人ID
     */
    @GetMapping(value = "/api/system/dept/leader/byId")
    R<Long> selectDeptLeaderById(@RequestParam("deptId") Long deptId);

    /**
     * 查询部门
     *
     * @return 部门列表
     */
    @GetMapping(value = "/api/system/dept/list")
    R<List<RemoteDeptVo>> selectDeptsByList();

    /**
     * 根据部门 ID 列表查询部门名称映射关系
     *
     * @param deptIds 部门 ID 列表
     * @return Map，其中 key 为部门 ID，value 为对应的部门名称
     */
    @GetMapping(value = "/api/system/dept/deptName/byDeptIds")
    R<Map<Long, String>> selectDeptNamesByIds(@RequestParam("deptIds") List<Long> deptIds);

}
